.. _cmlPmLtcReadLatch:

cmlPmLtcReadLatch 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

   VT_I4 cmlPmLtcReadLatch ([in] VT_I4 BoardID, [in] VT_I4 NodeId, [in] VT_I4 Channel, 
   [in] VT_I4 Counter, [out] VT_PR8 LatchedPos )                

DESCRIPTION
`````````````  

- 지정한 축의 현재 래치 된 카운트 값을 반환합니다. 이때 반환되는 위치 값의 단위는 논리적 거리 단위가 
  적용됩니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 사용자가 제어하고자 하는 노드 번호. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ Counter : 읽을 래치 카운터를 지정합니다. 이 값은 다음과 같습니다.

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning 
  0 (cmlCNT_COMM), 명령 위치 카운터(Command position counter) 
  1 (cmlCNT_FEED), 실제 위치 카운터(Feedback position counter) 
  2 (ccmlCNT_DEV), Deviation 또는 펄스 출력 속도 
  3 (ccmlCNT_GEN), General Counter 

▶ LatchedPos : 지정한 축의 래치 된 카운트 값을 반환합니다. 이때 반환되는 위치 값의 단위는 논리적 
거리 단위가 적용됩니다. 

RETURN VALUE
`````````````

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  ERR_NONE, 수행 성공


EXAMPLE
```````````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 
    long BoardID = 0; 
    // 0번 축의 래치 카운트를 Feedback position counter 로 설정하고 래치된 카운트 값을 반환합니다. 
    long nLtcCounter = cmlCNT_FEED; 
    double fLatchedPos = 0.0f;  
    cmlPmLtcReadLatche(BoardID, 0, ccmlX1, nLtcCounter, &nLatchedPos );


SEE ALSO
```````````

.. seealso:: :ref:`cmlPmLtcIsLatched`